Chapter 4 - Drawing
This is the second of eight chapters that discuss the OpenDoc programming interface in detail. This chapter describes how your part draws itself.Before reading this chapter, you should be familiar with the concepts presented in Chapter 1, "Introduction to OpenDoc," and Chapter 2, "Development Overview." You should also be familiar with the discussion of frames and facets presented in Chapter 3. For additional concepts related to your part editor's runtime environment, see Chapter 11, "OpenDoc Runtime Features." The discussion in this chapter also assumes that your are familiar with the platform-specific graphics system and drawing commands you need to draw your parts' content. For the Mac OS, this means QuickDraw or QuickDraw GX.
This chapter shows how your part
For a discussion of windows, the display structures within which all your drawing typically takes place, see Chapter 6, "Windows and Menus."
- uses canvases as drawing destinations
- uses transforms and shapes to lay out its contents
- draws itself to the screen
- prints itself
Chapter Contents
- Canvases
- Using Canvases
- Canvas Features
- Adding and Removing Canvases
- Transforms and Shapes
- Transforms and Coordinate Spaces
- Frame Coordinate Space
- Content Coordinate Space
- Converting to the Coordinates of a Containing Part
- Canvas Coordinates and Window Coordinates
- Coordinate Bias and Platform-Normal Coordinates
- Bias Transforms
- Content Extent
- The biasCanvas Parameter
- Using Transforms
- Scrolling Your Part in a Frame
- Transforming the Image of Your Part
- Positioning an Embedded Frame
- Transforming the Image of an Embedded Part
- Using Drawing-Related Shapes
- Frame Shape
- Used Shape
- Active Shape
- Clip Shape
- Managing Facet Clip Shapes
- Maintaining a List of Embedded Facets
- Calculating the Clip Shapes
- Embedded-Part Responsibilities
- Managing the Active Frame Border
- Adjusting the Active Frame Border
- Using Subframes to Suppress the Active Frame Border
- Drawing
- Defining General Display Characteristics
- View Type
- Presentation
- Part Info
- Basic Drawing
- Setting Up
- The Draw Method of Your Part Editor
- Invalidating and Validating Your Content
- Drawing on Opening a Window
- Drawing When a Window Is Scrolled
- Redrawing a Frame When It Changes
- Drawing When a Part Is Scrolled
- Drawing Selections
- Drawing With Scroll Bars
- Placing Scroll Bars Within Your Frame
- Clipping and Scrolling Your Content
- Clipping Embedded Frames
- Placing Scroll Bars in a Separate Frame
- Drawing Directly to the Window
- Asynchronous Drawing
- Offscreen Drawing
- Drawing to an Offscreen Canvas
- Updating an Offscreen Canvas
- Drawing With Multiple Frames or Facets
- Using Multiple Frames
- Using Multiple Facets
- Drawing an Embedded Frame Across Two Display Pages
- Multiple Views of an Embedded Frame
- Providing Split-Frame Views
- Printing
- Root-Part Responsibilities
- Supporting QuickDraw GX Printing
- Choosing a Frame for Printing
- Printing the Document
- Embedded-Part Responsibilities
- Engaging in Frame Negotiation
- Responding to GetPrintResolution
- Issues for All Parts
Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help